home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / x10cmdv2.zip / X10CMD.DOC < prev   
Text File  |  1992-02-02  |  4KB  |  128 lines
  1.                 X10 Direct Command - Version 2.0
  2.                 (c) 1992 Copyright by Paul Tauger
  3.  
  4.  
  5.                           Introduction
  6.  
  7. X10 Direct Command permits any MS-DOS computer to issue X10
  8. commands to an X-10 Powerhouse (tm) Computer Interface.  X10 Direct
  9. Command is ideal for controlling X10 modules from a remote
  10. computer.  The following X10 functions are supported:
  11.  
  12.      ON, OFF and DIM by Housecode and Module number
  13.      ALL UNITS OFF by Housecode
  14.      ALL LIGHTS ON by Housecode
  15.  
  16. In addition, X10 Direct Command now supports Preset files, batch
  17. files containing a series of X10 commands.
  18.  
  19.  
  20.                       Hardware Requirements
  21.  
  22. Any IBM-compatible computer, including 8088, 8086, V20, V30, 80286,
  23. 80386, 80386sx, 80486 and 80486sx machines.
  24.  
  25. MS-DOS 3.x or above.
  26.  
  27. X10 Powerhouse Computer Interface Model No. CP290 or equivalent.
  28.  
  29.                  Files Included in This Package
  30.  
  31. X10CMD.DOC     - This text file that you are reading.
  32. X10CMD-1.EXE   - X10CMD for COM1.
  33. X10CMD-2.EXE   - X10CMD for COM2.
  34. EVENING        - A sample Preset file.
  35.  
  36.                             Shareware
  37.  
  38. X10 Direct Command is NOT free, nor is it in the public domain. 
  39. X10 Direct Command is copyright, 1992, by its author, Paul Tauger. 
  40. All rights to the program, including the right to make copies,
  41. other than as provided in 17 U.S.C.  117, are reserved under 17
  42. U.S.C  101 et. seq.
  43.  
  44. You may distribute this program provided that:
  45.         The software and documentation are distributed as a single unit.
  46.         No changes are made to either the documentation or software.
  47.         It is distributed without charge.  "Without charge" means that
  48.         absolutely no money is charged for X10 Direct Command whether
  49.         directly or through "duplication fees", "media fees", etc.
  50.  
  51. If you find this program useful, you must pay for it.  A payment of
  52. $10 (very reasonable!) to the author will encourage him to continue
  53. writing shareware.  Please send all payments to:
  54.  
  55.      Paul Tauger
  56.      12312 Runnymede Street
  57.      North Hollywood, CA  91605
  58.  
  59. If you prefer, you may contact the author on his Bulletin Board:
  60.  
  61.      MIDIum BBS
  62.      (818) 764-4538
  63.      1200/2400/9600 baud 8/N/1, 24 hours a day, everyday
  64.  
  65. MIDIum permits on-line payment for X10 Direct Command with American
  66. Express or Optima cards.
  67.  
  68. X-10 and X-10 Powerhouse are the registered trademarks of X-10 USA
  69. Inc., 91 Ruckman Road, Closter, New Jersey 07624-0420.
  70.  
  71. X10 Direct Command is a common law trademark of Paul Tauger.
  72.  
  73.  
  74.                     Using X10 Direct Command
  75.  
  76. X10 Direct Command is completely command-line driven.  To send a
  77. command to the X10 Powerhouse, use the following syntax:
  78.  
  79.      x10cmd [housecode] [module] [command] [dimmer level]
  80.  
  81. where [housecode] is the housecode letter of the module you wish to
  82. control (A - P), [module] is the module number, from 1 to 16, and
  83. [command] is either ON, OFF or DIM.  [dimmer level] should be used
  84. only if the DIM command is used, and must be a number between 1 and
  85. 16.
  86.  
  87. To turn all modules off, the syntax is:
  88.  
  89.      x10cmd [housecode] ALLOFF
  90.  
  91. To turn all lights on, the syntax is:
  92.  
  93.      x10cmd [housecode] LIGHTSON
  94.  
  95. The command line may be either lower case or upper case.  Any
  96. errors in command line syntax are reported by the program.
  97.  
  98.                           Preset Files
  99.  
  100. Preset files are useful for creating pre-defined "scenes".  For
  101. example, a Preset file called EVENING could be useful when guests
  102. come for dinner: it could contain commands which would dim the
  103. living room lights and dining room lights to comfortable levels,
  104. turn on the lights in the guest bathroom, and turn off the lights
  105. in the rest of the house.
  106.  
  107. Preset files follow the same syntax as the X10 Direct Command
  108. command line.  They can be created using any ASCII text editor, or
  109. can even be created using the COPY CON command in DOS.  A sample
  110. preset file is reproduced below:
  111.  
  112.      b alloff
  113.      b 4 dim 8
  114.      b 7 dim 4
  115.      c 12 on
  116.      c 14 on
  117.  
  118. To run a Preset file, use the following syntax:
  119.  
  120.      x10cmd @[name of file]
  121.  
  122. For example, to run a Preset file called EVENING, you would type:
  123.  
  124.      x10cmd @evening
  125.  
  126. X10 Direct Command will accept any DOS-legal file name when
  127. preceeded by an @ symbol.
  128.